Understanding Report Engine search rules
Because Report Engine supports relative pathnames, you must understand the Report Engine search rules so that you know where it looks for files.
This section describes the locations and order in which the Report Engine searches for the following files:
- Image files
- Memo files
- Database files
- Report libraries
The following sections describe the search order and locations for each type of file. Each section contains a table that lists the path specification and identifies the locations where Report Engine searches for the files. A designation of not applicable (N/A) indicates that you cannot specify the path in that manner.
Image files
Table 2–2 lists the search order and locations where Report Engine searches for image files.
Table 2–2: Image file search order
|
Path specification
|
First location
|
Second location
|
Third location
|
|
Absolute path specified in report definition: <drive>:\<path>\<filename>
|
Specified <drive>:\
<filename>
|
Specified filename in default directory.
|
Specified filename in current working directory.
|
|
Relative path specified in report definition: <path>\<filename>
|
Specified <path>\
<filename> relative to default image directory.
|
Specified <path>\
<filename> relative to current working directory.
|
Not searched.
|
Memo files
Table 2–3 lists the search order and locations where Report Engine searches for memo files.
Table 2–3: Memo file search order
|
Path specification
|
First location
|
Second location
|
Third location
|
|
Absolute path specified in report definition: <drive>:\<path>\
<filename>
|
Specified
<drive>:\<path>\
<filename>
|
Specified filename in current working directory.
|
Not searched.
|
|
Relative path specified in report definition: <path>\<filename>
|
Specified
<path>\
<filename> relative to current working directory.
|
Not searched.
|
Not searched.
|
|
Absolute path specified using Report Engine parameter: <drive>:\<path>\
<filename> in RB-MEMO-FILE
|
Specified
<drive>:\<path>\
<filename>
|
Specified filename in current working directory.
|
Not searched.
|
|
Relative path specified using Report Engine parameter (<path>\
<filename> in RB-MEMO-FILE
|
Specified
<path>\
<filename> relative to current working directory.
|
Not searched.
|
Not searched.
|
Database files
Table 2–4 lists the search order and locations where Report Engine searches for local database files.
Table 2–4: Database files search order
|
Path specification
|
First location
|
Second location
|
Third location
|
|
Absolute path specified in report definition:
<drive>:\<path>\
<filename>
|
Specified
<drive>:\<path>\
<filename>
|
Not searched.
|
Not searched.
|
|
Relative path specified in report definition:
<path>\<filename>
|
Specified <path>\<filename> relative to current working directory.
|
Not searched.
|
Not searched.
|
|
Absolute path specified using Report Engine parameter
<drive>:\<path>\
<filename> in RB-DB-CONNECTION
|
Specified <drive>:\<path>\
<filename>
|
Not searched.
|
Not searched.
|
|
Relative path specified using Report Engine parameter
<path>\
<filename> in RB-DB-CONNECTION
|
Specified <path>\
<filename> relative to current working directory.
|
Not searched.
|
Not searched.
|
Report libraries
Table 2–5 lists the search order and locations where Report Engine searches for report libraries.
Table 2–5: Report library search order
|
Path specification
|
First location
|
Second location
|
Third location
|
|
Absolute path specified in Report Engine:
<drive>:\<path>\
<filename>
|
Specified <drive>:\<path>\
<filename>
|
Not searched.
|
Not searched.
|
|
Relative path specified in Report Engine:
<path>\<filename>
|
N/A
|
N/A
|
N/A
|
|
Absolute path specified using Report Engine parameter
<drive>:\<path>\
<filename> in RB-REPORT-LIBRARY
|
Specified <drive>:\<path>\
<filename>
|
Not searched.
|
Not searched.
|
|
Relative path specified using Report Engine parameter
<path>\
<filename> in RB-REPORT-LIBRARY
|
Specified <path>\
<filename> relative to default library directory.
|
Specified <path>\
<filename> relative to current working directory.
|
Not searched.
|